InBox TelegramNotification

Versão 6.1.0

Criação 28/04/2020

Recursos

O módulo envia notificações para o Telegram de números cadastrados no atendente e no usuário cliente.

Pré-requisitos

Framework

As seguintes versões de framework OTRS são suportadas:

  • [6.x.x]

Módulos

Os seguintes módulos são requeridos:

  • InBox Core 6.27.7 ou superior

Sistema Operacional

Os seguintes sistemas operacionais são requeridos:

  • [Nenhum]

Software de Terceiros

Os seguintes softwares de terceiros são requeridos:

  • [WWW::Telegram::BotAPI v0.12]

Instalação

bin/otrs.Console.pl Admin::Package::Install /path/to/InBox\ TelegramNotification 6.1.0.opm

Configuração

Este módulo deve ser configurado via Configuração do Sistema na interface administrativa. As seguintes opções de configurações estão disponíveis:

Instalar o software de terceiro WWW::Telegram::BotAPI v0.12

Instalar via terminal o software através do comando abaixo:

 cpan WWW::Telegram::BotAPI

Criar o bot no telegram

Acessar o telegram pesquisar por BotFather e seguir os passos para criação do bot:

Create Bot on telegram

Inserir o Token do Telegram bot

Ao criar o bot é gerado um token para acessar a API, e o mesmo deve ser inserido na config:

Token Bot Telegram

 Telegram::Config::Token

Telegram Token

Configurar as Notificações de chamado

Ao criar a notificação é preciso selecionar um evento que irá disparar a notificação.

Notification Event

E Habilitar o envio de notificação via Telegram:

Telegram Notification

A seleção de usuários para envio de notificação podem ser feitas de duas formas:

Através da configuração Destinatários:

Send Notification Recipients

E através do campo Destinatários Adicionais, é possível inserir mais de um número separados por virgula:

Additional Recipients

Obs.: Todos os números devem estar no padrão internacional e devem ter o sinal "+" no código do país. Exemplo: (+55), o DDD local (11). Os números cadastrados no campo Destinatários adicionais não podem coincidir com o telefone dos Clientes nem dos Atendentes.

Configurar a notificação que será enviada

Na notificação de texto, é preciso configurar as TAG's com as informações necessárias que serão encaminhadas via Telegram:

TAG Notification

obs: Para que a notificação seja enviada, Os numeros do cliente não podem coincidir com os numeros dos atendentes e vice versa.

Configurando o Telegram

Para configurar o Telegram basta iniciar o bot, que irá solicitar o compartilhamento do telefone para verificar se o usuário está cadastrado para receber as notificações.

Iniciando o bot:

Start bot Telegram

Será solicitado o compartilhamento do número do telefone:

Share contact

Enviando notificação para o Telegram

Com as configurações finalizadas, sempre que o evento for acionado, as notificação serão encaminhadas para os destinatários.

Como exemplo o evento disparado foi atualização de fila:

Event Change Queue

Ao ser disparado o evento a Notificação foi encaminhada para o destinatário:

Send Notification on telegram